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Reading and writing .obj files 


Object Files (.obj) 


Object files define the geometry and other properties for objects 
in Wavefront’s Advanced Visualizer. Object files can also be used 
to transfer geometric data back and forth between the Advanced 
Visualizer and other applications. 


Object files can be in ASCII format (.obj) or binary format (.mod). 
This booklet describes the ASCII format for object files. These 
files must have the extension .obj. 


The .obj file format supports both polygonal objects and free-form 
objects. Polygonal geometry uses points, lines, and faces to define 
objects while free-form geometry uses curves and surfaces. 


The curve and surface extensions to the .obj file format were 
developed in conjunction with mental images GmbH & Co. KG, 
Berlin, Germany, as part of a joint development project to 
incorporate free-form surfaces into Wavefront’s Advanced 
Visualizer. 


About this booklet 


This information is for those who want to use the .obj format to 
translate geometric data from their other software applications to 
Wavefront products. It also provides detailed information on the 
Wavefront .obj file format for Advanced Visualizer users. 


How this booklet is organized 


Most of this booklet describes the different parts of an .obj file 
and how those parts are arranged in the file. 


It includes the following sections: 

e File structure 

e General statement 

e Vertex data 

e Specifying free-form curves/surfaces 
e Free-form curve/surface attributes 


e Elements 


File structure 


e Free-form curve/surface body statements 
e Connectivity between free-form surfaces 
e Grouping 

e Display/render attributes 

¢ Comments 


e Mathematics for free-form curves/surfaces 


File structure 


The following types of data may be included in an .obj file. In this 
list, the keyword (in parentheses) follows the data type. 


Vertex data 

¢ geometric vertices (v) 
e texture vertices (vf) 

e vertex normals (vn) 


¢ parameter space vertices (vp) 


Free-form curve/surface attributes 


¢ rational or non-rational forms of curve or surface type: 
basis matrix, Bezier, B-spline, Cardinal, Taylor (cstype) 


e degree (deg) 
e basis matrix (bmat) 


e step size (step) 


Elements 
e point (p) 
e line (1) 
e face (f) 


e curve (curv) 
e 2D curve (curv2) 


e surface (surf) 


Free-form curve/surface body statements 
¢ parameter values (parm) 


¢ outer trimming loop (trim) 
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e inner trimming loop (hole) 
¢ special curve (scrv) 
¢ special point (sp) 


e end statement (end) 


Connectivity between free-form surfaces 


e connect (con) 


Grouping 

¢ group name (g) 

e¢ smoothing group (s) 
e merging group (mg) 
e object name (0) 


Display/render attributes 

e bevel interpolation (bevel) 

e color interpolation (c_interp) 

e dissolve interpolation (d_interp) 

e level of detail (Jod) 

e material name (usemtl) 

¢ material library (mtllib) 

e shadow casting (shadow_obj) 

e ray tracing (trace_obj) 

¢ curve approximation technique (ctech) 


¢ surface approximation technique (stech) 


General statement 


The following diagram shows how these parts fit together in a 
typical .obj file. 


grouping 
display/render attributes 


free-form attributes 
elements 
body statements 


grouping / attribute data 


| 
element data... | 


Figure 1. Typical .obj file structure 


General statement 
call filename.ext arg! arg2... 


Reads the contents of the specified .obj or .mod file at this 
location. The call statement can be inserted into .obj files using 
a text editor. 


filename.ext is the name of the .obj or .mod file to be read. You 
must include the extension with the filename. 


arg] arg2... specifies a series of optional integer arguments 
that are passed to the called file. There is no limit to the 
number of nested calls that can be made. 


Arguments passed to the called file are substituted in the 
same way as in UNIX scripts; for example, $1 in the called file 
is replaced by arg1, $2 in the called file is replaced by arg2, 
and so on. 


If the frame number is needed in the called file for variable 
substitution, “$1” must be used as the first argument in the 
call statement. For example: 


call filename.obj $1 
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Vertex data 


Then the statement in the called file, 
scmp filename.pv $1 


will work as expected. For more information on the semp 
statement, see appendix C, Variable Substitution. 


Another method to do the same thing is: 


scmp filename.pv $1 
call filename.obj 


Using this method, the scmp statement provides the .pv file for 
all subsequently called .obj or .mod files. 


csh command 
csh -command 


Executes the requested UNIX command. If the UNIX 
command returns an error, the parser flags an error during 
parsing. 

If a dash (-) precedes the UNIX command, the error is ignored. 


command is the UNIX command. 


Vertex data provides coordinates for: 

¢ geometric vertices 

e texture vertices 

e vertex normals 

For free-form objects, the vertex data also provides: 


¢ parameter space vertices 


The vertex data is represented by four vertex lists; one for each 
type of vertex coordinate. A right-hand coordinate system is used 
to specify the coordinate locations. 


Vertex data 


The following sample is a portion of an .obj file that contains the 
four types of vertex information. 


Vv -5.000000 5.000000 0.000000 
Vv -5.000000 -5.000000 0.000000 
W 5.000000 -5.000000 0.000000 
Vv 5.000000 5.000000 0.000000 
vt -5.000000 5.000000 0.000000 
vt -5.000000 -5.000000 0.000000 
vt 5.000000 -5.000000 0.000000 
WAS 5.000000 5.000000 0.000000 
vn 0.000000 0.000000 1.000000 
vn 0.000000 0.000000 1.000000 
vn 0.000000 0.000000 1.000000 
vn 0.000000 0.000000 1.000000 
vp 0.210000 3.590000 

vp 0.000000 0.000000 

vp 1.000000 0.000000 

vp 0.500000 0.500000 


When vertices are loaded into the Advanced Visualizer, they are 
sequentially numbered, starting with 1. These reference numbers 
are used in element statements. 


Syntax 
The following syntax statements are listed in order of complexity. 
VXyYZW 


Polygonal and free-form geometry statement. 

Specifies a geometric vertex and its x y z coordinates. Rational 
curves and surfaces require a fourth homogeneous 
coordinate, also called the weight. 


x y zare the x, y, and z coordinates for the vertex. These are 
floating point numbers that define the position of the vertex 
in three dimensions. 


w is the weight required for rational curves and surfaces. It is 
not required for non-rational curves and surfaces. If you do 
not specify a value for w, the default is 1.0. 


Tip A positive weight value is recommended. Using zero or negative 
values may result in an undefined point in a curve or surface. 
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vp uvw 


Free-form geometry statement. 
Specifies a point in the parameter space of a curve or surface. 


The usage determines how many coordinates are required. 
Special points for curves require a 1D control point (u only) in 
the parameter space of the curve. Special points for surfaces 
require a 2D point (u and v) in the parameter space of the 
surface. Control points for non-rational trimming curves 
require u and v coordinates. Control points for rational 
trimming curves require u, v, and w (weight) coordinates. 


u is the point in the parameter space of a curve or the first 
coordinate in the parameter space of a surface. 


v is the second coordinate in the parameter space of a surface. 


w is the weight required for rational trimming curves. If you 
do not specify a value for w, it defaults to 1.0. 


For additional information on parameter vertices, see the curv2 
and sp statements. 


vn ijk 


Polygonal and free-form geometry statement. 
Specifies a normal vector with components i, j, and k. 


Vertex normals affect the smooth-shading and rendering of 
geometry. For polygons, vertex normals are used in place of 
the actual facet normals. For surfaces, vertex normals are 
interpolated over the entire surface and replace the actual 
analytic surface normal. 


When vertex normals are present, they supersede smoothing 
groups. 


ij k are the i,j, and k coordinates for the vertex normal. They 
are floating point numbers. 


vt uvw 


Vertex statement for both polygonal and free-form geometry. 
Specifies a texture vertex and its coordinates. A 1D texture 
requires only u texture coordinates, a 2D texture requires both 
u and v texture coordinates, and a 3D texture requires all three 
coordinates. 


Specifying free-form curves/surfaces 


u is the value for the horizontal direction of the texture. 


v is an optional argument. 
v is the value for the vertical direction of the texture. The 
default is 0. 


w is an optional argument. 
w is a value for the depth of the texture. The default is 0. 


Specifying free-form curves/surfaces 


There are three steps involved in specifying a free-form curve or 
surface element. 


Specify the type of curve or surface (basis matrix, Bezier, 
B-spline, Cardinal, or Taylor) using free-form curve/surface 
attributes. 


Describe the curve or surface with element statements. 


Supply additional information, using free-form 
curve/surface body statements. 


The next three sections provide detailed information on each of 
these steps. 


Data requirements for curves and surfaces 


All curves and surfaces require a certain set of data. This consists 
of the following: 


Free-form curve/surface attributes 


All curves and surfaces require type data, which is given 
with the cstype statement. 


All curves and surfaces require degree data, which is given 
with the deg statement. 


Basis matrix curves or surfaces require a bmat statement. 


Basis matrix curves or surfaces also require a step size, which 
is given with the step statement. 
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Elements 


e All curves and surfaces require control points, which are 
referenced in the curv, curv2, or surf statements. 


e 3D curves and surfaces require a parameter range, which is 
given in the curv and surf statements, respectively. 


Free-form curve/surface body statements 


e  Allcurves and surfaces require a set of global parameters or a 
knot vector, both of which are given with the parm statement. 


e Allcurves and surfaces body statements require an explicit 
end statement. 


Error checks 


The above set of data starts out empty with no default values 
when reading of an .obj file begins. While the file is being read, 
statements are encountered, information is accumulated, and 
some errors may be reported. 


When the end statement is encountered, the following error 
checks, which involve consistency between various statements, 
are performed: 


e All required information is present. 


¢ The number of control points, number of parameter values 
(knots), and degree are consistent with the curve or surface 
type. If the type is bmatrix, the step size is also consistent. (For 
more information, refer to the parameter vector equations in 
the section, “Mathematics for free-form curves/surfaces” on 
page 60.) 

e If the type is bmatrix and the degree is n, the size of the basis 
matrix is (n + 1) x (n + 1). 


Any information given by the state-setting statements remains in 
effect from one curve or surface to the next. Information given 
within a curve or surface body is only effective for the curve or 
surface it is given with. 


Free-form curve/surface attributes 


Free-form curve/surface attributes 


Syntax 


Five types of free-form geometry are available in the .obj file 
format: 


e =6Bezier 

e basis matrix 
e B-spline 

e Cardinal 

e Taylor 


You can apply these types only to curves and surfaces. Each of 
these five types can be rational or non-rational. 


In addition to specifying the type, you must define the degree for 
the curve or surface. For basis matrix curve and surface elements, 
you must also specify the basis matrix and step size. 


All free-form curve and surface attribute statements are 
state-setting. This means that once an attribute statement is set, it 
applies to all elements that follow until it is reset to a different 
value. 


The following syntax statements are listed in order of use. 
cstype rat type 


Free-form geometry statement. 
Specifies the type of curve or surface and indicates a rational 
or non-rational form. 


rat is an optional argument. 
rat specifies a rational form for the curve or surface type. If rat 
is not included, the curve or surface is non-rational. 


type specifies the curve or surface type. Allowed types are: 


bmatrix basis matrix 
bezier Bezier 
bspline B-spline 
cardinal Cardinal 
taylor Taylor 


There is no default. A value must be supplied. 
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Free-form curve/surface attributes 


deg degu degv 


Free-form geometry statement. 
Sets the polynomial degree for curves and surfaces. 


degu is the degree in the u direction. It is required for both 
curves and surfaces. 


degv is the degree in the v direction. It is required only for 
surfaces. For Bezier, B-spline, Taylor, and basis matrix, there 
is no default; a value must be supplied. For Cardinal, the 
degree is always 3. If some other value is given for Cardinal, 
it will be ignored. 


bmat u matrix 
bmat v matrix 
Free-form geometry statement. 
Sets the basis matrices used for basis matrix curves and 


surfaces. The u and v values must be specified in separate 
bmat statements. 


Tip The deg statement must be given before the bmat statements and 
the size of the matrix must be appropriate for the degree. 


u specifies that the basis matrix is applied in the u direction. 
v specifies that the basis matrix is applied in the v direction. 


matrix lists the contents of the basis matrix with column 
subscript j varying the fastest. If n is the degree in the given u 
or v direction, the matrix (i,j) should be of size (n + 1) x (n + 1). 


There is no default. A value must be supplied. 


Tip The arrangement of the matrix is different from that commonly 
found in other references. For more information, see the examples 
at the end of this section and also the section,” Mathematics for 
free-form curves/surfaces” on page 60. 
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Free-form curve/surface attributes 


step stepu stepv 


Free-form geometry statement. 
Sets the step size for curves and surfaces that use a basis 
matrix. 


stepu is the step size in the u direction. It is required for both 
curves and surfaces that use a basis matrix. 


stepv is the step size in the v direction. It is required only for 
surfaces that use a basis matrix. There is no default. A value 
must be supplied. 


When a curve or surface is being evaluated and a transition 
from one segment or patch to the next occurs, the set of 
control points used is incremented by the step size. The 
appropriate step size depends on the representation type, 
which is expressed through the basis matrix, and on the 
degree. 


That is, suppose we are given a curve with k control points: 
UG acc Hate 


If the curve is of degree n, then n + 1 control points are needed 
for each polynomial segment. If the step size is given as s, then 
the ith polynomial segment, where i = 0 is the first segment, 
will use the control points: 


{Vis4 ee Vistnt I 


For example, for Bezier curves, s =n. 


For surfaces, the above description applies independently to 
each parametric direction. 


When you create a file which uses the basis matrix type, be 
sure to specify a step size appropriate for the current curve or 
surface representation. 
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Examples 
1 Cubic Bezier surface made with a basis matrix 
To create a cubic Bezier surface: 


cstype bmatrix 


deg 3 3 

step 3 3 

bmat u al -3 3 =1 \ 
0 3 -6 B \ 
0 0 3 =3 \ 
0 0 0 Al 

bmat v 1 -3 3 -1 \ 
0 3 -6 3 \ 
0 0 3 =15) \ 
0) 0) 0 i 


2 Hermite curve made with a basis matrix 
To create a Hermite curve: 


cstype bmatrix 

deg 3 

step 2 

bmat u il 0 =3 2 0 0 3 =) 
0 al -2 1 0 0 =1 1 


3 Bezier in u direction with B-spline in v direction; 
made with a basis matrix 


To create a surface with a cubic Bezier in the u direction and 
cubic uniform B-spline in the v direction: 


cstype bmatrix 


deg 3 3 

step 3 1 

bmat u fl -3 B =1 \ 
0 3 -6 3 \ 
0 0 3} =3 \ 
0 0 0 Al 

bmat v 0.16666 -0.50000 0.50000 -0.16666 \ 
0.66666 0.00000 -1.00000 0.50000 \ 
0.16666 0.50000 0.50000 -0.50000 \ 
0.00000 0.00000 0.00000 0.16666 
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Elements 


Elements 


For polygonal geometry, the element types available in the .obj 
file are: 


¢ points 
e lines 
e = faces 


For free-form geometry, the element types available in the .obj file 
are: 


e curve 
e 2D curve ona surface 


e surface 


All elements can be freely intermixed in the file. 


Referencing vertex data 


For all elements, reference numbers are used to identify 
geometric vertices, texture vertices, vertex normals, and 
parameter space vertices. 


Each of these types of vertices is numbered separately, starting 
with 1. This means that the first geometric vertex in the file is 1, 
the second is 2, and so on. The first texture vertex in the file is 1, 
the second is 2, and so on. The numbering continues sequentially 
throughout the entire file. Frequently, files have multiple lists of 
vertex data. This numbering sequence continues even when 
vertex data is separated by other data. 


In addition to counting vertices down from the top of the first list 
in the file, you can also count vertices back up the list from an 
element's position in the file. When you count up the list from an 
element, the reference numbers are negative. A reference number 
of -1 indicates the vertex immediately above the element. A 
reference number of -2 indicates two references above and so on. 


Referencing groups of vertices 
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Some elements, such as faces and surfaces, may have a triplet of 
numbers that reference vertex data. These numbers are the 
reference numbers for a geometric vertex, a texture vertex, and a 
vertex normal. 
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Each triplet of numbers specifies a geometric vertex, texture 
vertex, and vertex normal. The reference numbers must be in 
order and must separated by slashes (/). 


e The first reference number is the geometric vertex. 


e The second reference number is the texture vertex. It follows 
the first slash. 


e The third reference number is the vertex normal. It follows 
the second slash. 


There is no space between numbers and the slashes. There may 
be more than one series of geometric vertex /texture 
vertex /vertex normal numbers on a line. 


The following is a portion of a sample file for a four-sided face 
element: 


EL 2/ 212 3/3/73 4/4/74 


Using v, vt, and vn to represent geometric vertices, texture 
vertices, and vertex normals, the statement would read: 


£ v/vt/vn v/vt/vn v/vt/vn v/vt/vn 


If there are only vertices and vertex normals for a face element 
(no texture vertices), you would enter two slashes (//). For 
example, to specify only the vertex and vertex normal reference 
numbers, you would enter: 


1 YY UD SS 


When you are using a series of triplets, you must be consistent in 
the way you reference the vertex data. For example, it is illegal to 
give vertex normals for some vertices, but not all. 


The following is an example of an illegal statement. 


EI 2/202 3) (3 4ePa 


The following syntax statements are listed in order of complexity 
of geometry. 


p v7 v2 v3... 


Polygonal geometry statement. 
Specifies a point element and its vertex. You can specify 
multiple points with this statement. Although points cannot 
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be shaded or rendered, they are used by other Advanced 
Visualizer programs. 


v is the vertex reference number for a point element. Each 
point element requires one vertex. Positive values indicate 
absolute vertex numbers. Negative values indicate relative 
vertex numbers. 


| viIAtt v2Ni2 v3Nt3... 


Polygonal geometry statement. 

Specifies a line and its vertex reference numbers. You can 
optionally include the texture vertex reference numbers. 
Although lines cannot be shaded or rendered, they are used 
by other Advanced Visualizer programs. 


The reference numbers for the vertices and texture vertices 
must be separated by a slash (/). There is no space between 
the number and the slash. 


vis areference number for a vertex on the line. A minimum of 
two vertex numbers are required. There is no limit on the 
maximum. Positive values indicate absolute vertex numbers. 
Negative values indicate relative vertex numbers. 


vt is an optional argument. 
ut is the reference number for a texture vertex in the line 
element. It must always follow the first slash. 


f viINtiWnt v2Vt2Wn2 v3Nt3/vni... 


Polygonal geometry statement. 

Specifies a face element and its vertex reference number. You 
can optionally include the texture vertex and vertex normal 
reference numbers. 


The reference numbers for the vertices, texture vertices, and 
vertex normals must be separated by slashes (/). There is no 
space between the number and the slash. 


v is the reference number for a vertex in the face element. A 
minimum of three vertices are required. 


vt is an optional argument. 
ut is the reference number for a texture vertex in the face 
element. It always follows the first slash. 


Wavefront Object File Format 


Object Files (.obj) 


Elements 


vn is an optional argument. 
vn is the reference number for a vertex normal in the face 
element. It must always follow the second slash. 


Face elements use surface normals to indicate their 
orientation. If vertices are ordered counterclockwise around 
the face, both the face and the normal will point toward the 
viewer. If the vertex ordering is clockwise, both will point 
away from the viewer. If vertex normals are assigned, they 
should point in the general direction of the surface normal, 
otherwise unpredictable results may occur. 


If a face has a texture map assigned to it and no texture 
vertices are assigned in the f statement, the texture map is 
ignored when the element is rendered. 


curv u0 u71 v7 V2... 


Element statement for free-form geometry. 

Specifies a curve, its parameter range, and its control vertices. 
Although curves cannot be shaded or rendered, they are used 
by other Advanced Visualizer programs. 


u0 is the starting parameter value for the curve. This is a 
floating point number. 


ul is the ending parameter value for the curve. This is a 
floating point number. 


v is the vertex reference number for a control point. You can 
specify multiple control points. A minimum of two control 
points are required for a curve. 


For a non-rational curve, the control points must be 3D. For a 
rational curve, the control points are 3D or 4D. The fourth 
coordinate (weight) defaults to 1.0 if omitted. 


curv2 vp? vp2 vp3... 


Free-form geometry statement. 

Specifies a 2D curve on a surface and its control points. A 2D 
curve is used as an outer or inner trimming curve, as a special 
curve, or for connectivity. 


up is the parameter vertex reference number for the control 
point. You can specify multiple control points. A minimum of 
two control points is required for a 2D curve. 
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The control points are parameter vertices because the curve 
must lie in the parameter space of some surface. For a 
non-rational curve, the control vertices can be 2D. For a 
rational curve, the control vertices can be 2D or 3D. The third 
coordinate (weight) defaults to 1.0 if omitted. 


surf sO s7 tO t1 viWttWvn1 v2\t2\n2... 


Element statement for free-form geometry. 

Specifies a surface, its parameter range, and its control 
vertices. The surface is evaluated within the global parameter 
range from sO to s1 in the u direction and £0 to t1 in the v 
direction. 


s0 is the starting parameter value for the surface in the u 
direction. 


s1 is the ending parameter value for the surface in the u 
direction. 


t0 is the starting parameter value for the surface in the v 
direction. 


t1 is the ending parameter value for the surface in the v 
direction. 


v is the reference number for a control vertex in the surface. 


vt is an optional argument. 
ut is the reference number for a texture vertex in the surface. 
It must always follow the first slash. 


vn is an optional argument. 
vn is the reference number for a vertex normal in the surface. 
It must always follow the second slash. 


For a non-rational surface the control vertices are 3D. For a 
rational surface the control vertices can be 3D or 4D. The 
fourth coordinate (weight) defaults to 1.0 if omitted. 


For more information on the ordering of control points for 
surfaces, refer to the section on surfaces and control points in 
“Mathematics for free-form curves/surfaces” on page 60. 
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These are examples for polygonal geometry. 


Elements 


For examples using free-form geometry, see the examples in 


“Free-form curve/surface body statements” on page 21. 


1 


Square 


This example shows a square that measures two units on each 
side and faces in the positive direction (toward the camera). 
Note that the ordering of the vertices is counterclockwise. 
This ordering determines that the square is facing forward. 
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Cube with negative reference numbers 


This is a cube with negative vertex reference numbers. Each 
element references the vertices stored immediately above it in 
the file. Note that vertices are not shared. 


mM<a<< << mMm<s<s<< i m<a<4< <4 mh<4<4<4 4 


m<a<<< 


0.000000 
0.000000 
2.000000 
2.000000 
at 3) 22 


- 000000 
- 000000 
. 000000 
- 000000 
Sil 8) =e 


OONN 


- 000000 
- 000000 
- 000000 
- 000000 
aU 8) 


NONN NY 


0.000000 
0.000000 
2.000000 
2.000000 
=U Ss) 7) 


-000000 
- 000000 
-000000 
-000000 
Sl, 8) 


ey te (erie) 


0.000000 
0.000000 
2.000000 
2.000000 
Sul 8) 


2.000000 
0.000000 
0.000000 
2.000000 


. 000000 
- 000000 
- 000000 
- 000000 


- 000000 
- 000000 
- 000000 
- 000000 


- 000000 
- 000000 
- 000000 
- 000000 


2.000000 
0.000000 
0.000000 
2.000000 


0.000000 
0.000000 
0.000000 
0.000000 
ale 


2 


ONNO COON N (ey (2) =) (2) 


ON OO 


DEO. Orb 


- 000000 
2.000000 
Je 

2.000000 


000000 


- 000000 
.000000 
- 000000 
- 000000 


000000 
000000 
000000 
. 000000 


- 000000 
- 000000 
- 000000 
- 000000 


- 000000 
- 000000 
- 000000 
- 000000 


000000 
. 000000 
- 000000 
000000 
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Free-form curve/surface body statements 


Object Files (.obj) 


You can specify additional information for free-form curve and 
surface elements using a series of statements called body 
statements. The series is concluded by an end statement. 


Body statements are valid only when they appear between the 
free-form element statement (curv, curv2, surf) and the end 
statement. If they are anywhere else in the .obj file, they do not 
have any effect. 


You can use body statements to specify the following values: 


e parameter 

e knot vector 

¢ trimming loop 

e hole 

° special curve 

e special point 

You cannot use any other statements between the free-form curve 


or surface statement and the end statement. Using any other of 
type of statement may cause unpredictable results. 


This portion of a sample file shows the knot vector values for a 
rational B-spline surface with a trimming loop. Notice the end 
statement to conclude the body statements. 


cstype rat bspline 

deg 2 2 

sur£— -1.0 2.5 -2.0 2.0 -9 -8 -7 -6 -5 -4 -3 -2 -1 
Parme we = 1200 =A 00 OOM 25.02.50) 250 

parm v -2.00 -2.00 -2.00 -2.00 -2.00 -2.00 

tengabiag (0)-(0) 24-0) al 

end 


Parameter values and knot vectors 


All curve and surface elements require a set of parameter values. 


For polynomial curves and surfaces, this specifies global 
parameter values. For B-spline curves and surfaces, this specifies 
the knot vectors. 
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Free-form curve/surface body statements 


For surfaces, the parameter values must be specified for both the 
uand v directions. For curves, the parameter values must be 
specified for only the u direction. 


If multiple parameter value statements for the same parametric 
direction are used inside a single curve or surface body, the last 
statement is used. 


Trimming loops and holes 


The trimming loop statement builds a single outer trimming loop 
as a sequence of curves which lie on a given surface. 


The hole statement builds a single inner trimming loop as a 
sequence of curves which lie on a given surface. The inner loop 
creates a hole. 


The curves are referenced by number in the same way vertices 
are referenced by face elements. 


The individual curves must lie end-to-end to form a closed loop 
which does not intersect itself and which lies within the 
parameter range specified for the surface. The loop as a whole 
may be oriented in either direction (clockwise or 
counterclockwise). 


To cut one or more holes in a region, use a trim statement 
followed by one or more hole statements. To introduce another 
trimmed region in the same surface, use another trim statement 
followed by one or more hole statements. The ordering that 
associates holes and the regions they cut is important and must 
be maintained. 


If the first trim statement in the sequence is omitted, the 
enclosing outer trimming loop is taken to be the parameter range 
of the surface. If no trim or hole statements are specified, then the 
surface is trimmed at its parameter range. 
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Free-form curve/surface body statements 


This portion of a sample file shows a non-rational Bezier surface 
with two regions, each with a single hole: 


cstype bezier 
deg 1 1 

surf 
parm 
parm 
encom 
hole 
(eegraciay! 
hole 
end 


PAG) We) Asa th A sh a! 
00 2.00 

00 2.00 

4. 
4 
4 
4 


OVOorece: se So 
eo} tey fo} fe) ey fey fe) 
ore yrs: 
BWDH Ee 


Special curve 


A special curve statement builds a single special curve as a 
sequence of curves which lie on a given surface. 


The curves are referenced by number in the same way vertices 
are referenced by face elements. 


A special curve is guaranteed to be included in any triangulation 
of the surface. This means that the line formed by approximating 
the special curve with a sequence of straight line segments will 
actually appear as a sequence of triangle edges in the final 
triangulation. 


Special point 


A special point statement specifies that special geometric points 
are to be associated with a curve or surface. For space curves and 
trimming curves, the parameter vertices must be 1D. For 
surfaces, the parameter vertices must be 2D. 


These special points will be included in any linear approximation 
of the curve or surface. 


For space curves, this means that the point corresponding to the 
given curve parameter is included as one of the vertices in an 
approximation consisting of a sequence of line segments. 


For surfaces, this means that the point corresponding to the given 
surface parameters is included as a triangle vertex in the 
triangulation. 
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Syntax 


For trimming curves, the treatment is slightly different: a special 
point on a trimming curve is essentially the same as a special 
point on the surface it trims. 


The following portion of a sample file shows special points for a 
rational Bezier 2D curve on a surface. 


vp -0.675 21.850 3.000 
vp OOS) 1.9310 

vp 2.485) 064710) 2) 01010 
VDI 25s OS 

vp 1.605 -1.890 10.700 
vp -0.745 -0.654 0.500 
cstype rat bezier 

curve -6 -5 =-4 -3 -2 -1 -6 
joxewetan) Wl (0) OO) Al (Oe) 4 10)l0) 
sje)  } 

end 


The following syntax statements are listed in order of normal use. 


parm u p7 p2 p32... 
parm vp7 p2 p3... 
Body statement for free-form geometry. 


Specifies global parameter values. For B-spline curves and 
surfaces, this specifies the knot vectors. 


u is the u direction for the parameter values. 
v is the v direction for the parameter values. 
To set u and v values, use separate command lines. 


p is the global parameter or knot value. You can specify 
multiple values. A minimum of two parameter values are 
required. Parameter values must increase monotonically. The 
type of surface and the degree dictate the number of values 
required. 


trim uO u7 curv2d ud ul curv2d... 


Body statement for free-form geometry. 
Specifies a sequence of curves to build a single outer trimming 
loop. 


uO is the starting parameter value for the trimming curve 
curv2d. 
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ul is the ending parameter value for the trimming curve 
curv2d. 


curv2d is the index of the trimming curve lying in the 
parameter space of the surface. This curve must have been 
previously defined with the curv2 statement. 


hole uO ul curv2d ud ul curv2d... 


Body statement for free-form geometry. 
Specifies a sequence of curves to build a single inner trimming 
loop (hole). 


u0 is the starting parameter value for the trimming curve 
curv2d. 


ul is the ending parameter value for the trimming curve 
curo2d. 


curv2d is the index of the trimming curve lying in the 
parameter space of the surface. This curve must have been 
previously defined with the curv2 statement. 


scrv u0 u7 curv2d u0 ul curva2d... 


Body statement for free-form geometry. 
Specifies a sequence of curves which lie on the given surface 
to build a single special curve. 


u0 is the starting parameter value for the special curve curv2d. 
ul is the ending parameter value for the special curve curv2d. 


curv2d is the index of the special curve lying in the parameter 
space of the surface. This curve must have been previously 
defined with the curv2 statement. 


sp vp7 vp... 


Body statement for free-form geometry. 

Specifies special geometric points to be associated with a 
curve or surface. For space curves and trimming curves, the 
parameter vertices must be 1D. For surfaces, the parameter 
vertices must be 2D. 


up is the reference number for the parameter vertex of a 
special point to be associated with the parameter space point 
of the curve or surface. 
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end 


Body statement for free-form geometry. 
Specifies the end of a curve or surface body begun by a curv, 
curv2, or surf statement. 


Taylor curve 


For creating a single-segment Taylor polynomial curve of the 
form: 


X = BOSE hn TOSS ES SCIE: CoumGns Ec 
y = io WO ie ¢ Boies = Mae OD Oshe 
A Se pss = Wales Salo a (olche 


and evaluated between the global parameters 0.5 and 1.6: 


NA Shc O}LONL0) 1.000 -2.500 
We AG SOO) -10.100 0.500 
vy 7.980 5.400 -7.000 
NP thin SOL) -4.700 alesse aK(ONlo) 
v 6.340 271030 0.080 
estype taylor 

deg 4 


cum OF 50016008 23455 
parm u 0.000 2.000 
end 
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Bezier curve 


This example shows a non-rational Bezier curve with 13 
control points. 


-2.300000 1.950000 0.000000 
-2.200000 0.790000 0.000000 
-2.340000 -1.510000 0.000000 
-1.530000 -1.490000 0.000000 
-0.720000 -1.470000 0.000000 
-0.780000 0.230000 0.000000 
0.070000 0.250000 0.000000 
0.920000 0.270000 0.000000 
0.800000 -1.610000 0.000000 
1.620000 -1.590000 0.000000 
2.440000 -1.570000 0.000000 
2.690000 0.670000 0.000000 
2.900000 1.980000 0.000000 
13 vertices 


#qdgdqgq@<sa<ssssessea404 46 


cstype bezier 

ctech cparm 1.000000 

deg 3 

Cury 0000000) 4.000000" 253.4565 753 9510) X 
skal able als! 

parm u 0.000000 1.000000 2.000000 3.000000 \ 
4.000000 

end 

# 1 element 


Zh 
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B-spline surface 


This is an example of a cubic B-spline surface. 


bspatch 


5) 


Ore 


meg eg@ddddqdededdddddde 
pa 


- 000000 
000000 
.000000 
- 000000 
- 666667 
- 666667 
- 666667 
- 666667 


- 666667 
- 666667 
- 666667 
- 666667 
.000000 
.000000 
.000000 
.000000 
6 vertices 


—S V0 00O0=/ 808327 
=TSOOO6O) =7 08327 
1.666667 -7.808327 
5.000000 -7.808327 
-5.000000 -7.808327 
Sl OOO OOr/ aT 717 8.0) 
TOo6667 UIT 977730 
5.000000 -7.808327 
=5'. 000000 —7 3808327 
AG OOOO) sell Od 7. 8.0) 
Pe OCOOG7 to 7 77180 
5.000000 -7.808327 
-5.000000 -7.808327 
OCC OOr ma OUS Sau 
1.666667 -7.808327 
5.000000 -7.808327 


cstype bspline 
stech curv 0.5 10.000000 


deg 


3 3 


8surf 0.000000 1.000000 0.000000 1.000000 13 14 \ 
dss ile; ) alo) al, by Sy Gy teh ih es) 

parm u -3.000000 -2.000000 -1.000000 0.000000 \ 
1.000000 2.000000 3.000000 4.000000 

parm v -3.000000 -2.000000 -1.000000 0.000000 \ 
1.000000 2.000000 3.000000 4.000000 


end 


# 1 element 
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4 Cardinal surface 
This example shows a Cardinal surface. 


-5.000000 -5.000000 0.000000 
-5.000000 -1.666667 0.000000 
-5.000000 1.666667 0.000000 
-5.000000 5.000000 0.000000 
-1.666667 -5.000000 0.000000 
-1.666667 -1.666667 0.000000 
-1.666667 1.666667 0.000000 
-1.666667 5.000000 0.000000 
1.666667 -5.000000 0.000000 
1.666667 -1.666667 0.000000 
1.666667 1.666667 0.000000 
1.666667 5.000000 0.000000 
5.000000 -5.000000 0.000000 
5.000000 -1.666667 0.000000 
5.000000 1.666667 0.000000 
5.000000 5.000000 0.000000 
16 vertices 


#gdacssessess90S9 99909909 9 


cstype cardinal 

stech cparma 1.000000 1.000000 

degquen 

surf 0.000000 1.000000 0.000000 1.000000 13 14 \ 
ie) aly &) Wo) ah ae 4G 7 Gs al as 4 

parm u 0.000000 1.000000 

parm v 0.000000 1.000000 

end 

# 1 element 
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Rational B-spline surface 


This example creates a second-degree, rational B-spline 
surface using open, uniform knot vectors. A texture map is 


applied to the surface. 


ale 3) 


q«ssss99°9 9 


We OS Ole e201 ot 


xe, 1h 5 (0) 


deg 2 2 


all, 4 
sales 
eal 


oO 


ule 
cstype rat bspline 


[— [= tS) Kel te) toy fey fen le) a) (er te) 
Cy KS Kea tx) er) Mon) tet (Ss ete tet rey te) to) te) feet tee te) 


Oo Oro OO [OTe oS 


QWo PP WON © fF © 


wo 4 


WaNrFR O 
Wr WU UI 


W OV 


hbkesd WoO as@ Woh tel abyil Ayr Shs Wyk Bieey ayy \ 
DEW ees) QYS 


parm u 0.0 
parm v 0.0 


end 


0.0 
0.0 
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Trimmed NURB surface 


This is a complete example of a file containing a trimmed 
NURB surface with negative reference numbers for vertices. 


# trimming curve 

Vir = On67/5 den S50) 630100 
acl (a Walisy ih ot) sh) 

Vp 2.485 04710" 2510100 
vp 2.485 -1.030 

vp 1.605 -1.890 10.700 
vp -0.745 -0.654 0.500 
cstype rat bezier 

deg 3 

curv2 -6 -5 -4 -3 -2 -1 -6 
parm u 0.00 1.00 2.00 


end 

# surface 

v -1.350 -1.030 0.000 
Ose eSi Oars Om Oye say 16 010) 
v 1.480 -1.030 0.000 2.300 
v -1.460 0.060 0.201 

Vi On 20 OOOO OL S05 010 
v 1.380 0.060 0.454 1.500 
v -1.480 1.030 0.000 2.300 
ve ORLZ0 Si sOsi00nsS4) 65100 
Vale OMe OS Om On OO OMS s010 
cstype rat bspline 

deg 2 2 


surf -1.0 2.5 -2.0 2.0 -9 -8 -7 -6 -5 -4 -3 -2 -1 
PaLmeatie—eO0R O01 O02 S0N25 502.510 

parm v -2.00 -2.00 -2.00 -2.00 -2.00 -2.00 

jar CO) Bao) al 

end 
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7 Twotrimming regions with a hole 


This example shows a Bezier surface with two trimming 
regions, each with a hole in them. 


# outer loop of first region 
deg 1 

cstype bezier 

vp 0.100 0.100 

vp) OF D000 LOO 

vp 0.900 0.900 

vp 0.100 0.900 

Cube al 2s} ah al 

Dacm a OMO0 OOM 200) 3 OO MA 010 
end 

# hole in first region 

vp 0.300 0.300 

vp 0.700 0.300 

vp 0.700 0.700 

vp 0.300 0.700 

ube By GY 3) (5) 

parm Ww 0.00) 1700 2.00) 3200) 42.00 
end 

# outer loop of second region 
On leeelOlO) ele O10) 

vp 1.900 1.100 

vp 1.900 1.900 

vip LOOM S00 

(elihreni) 2) AN) ala alba} te) 

DALM ete OmO Om lO Om Ze OOS OOO 
end 

# hole in second region 

nae) dba SiO) ale SHe)) 

vas) AS OO) A sileNe) 

xiao) Ibs Zoo) al FON) 

Vids 00 57/00) 

Gina sls) alle allsy ale) alls! 

Pacmn OnOO mn OOM 2. OOS 00) 42010 


end 

# surface 

v 0.000 0.000 0.000 
Va OOO MORO OO MORO 
v 0.000 1.000 0.000 
Velen O OOM OO 0MOR O00 
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deg 1 1 


cstype 


ishuhene 
parm 
parm 
trim 
hole 
ism 


hole 


end 


(Site) ferie) <<) (a) fo) 


(el fete) (erie) faye) 


(Sy (SI Sy KS) 


4 
4. 
4 


bezier 

Pel) Ws) AAs) dh PP sh ea 
OOM 010 

OO 21010: 

ays 


mW DO 
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Trimming with a special curve 


This example is similar to the example, “Trimmed NURB 
surface” on page 31, except there is a special curve on the 
surface. This example uses negative vertex numbers. 


# trimming curve 


- 600 
-300 


-500 
-500 
.300 
100 
-300 


=i20 2,5 =28.0 A,0 29) se) oy =6 ob od) oer = aul 
Bh =, 00) 00) AO) ASO Aca) Ahold) 
Ye —76 00) —Ao0C “250 AoW) Ao) 210K) 


VD OO Dir DOs O00) 
igo) OO) SSS) aS SISO) 

Wo AoW4S Wyo 2,00) 
vp 2.485 -1.030 

vp 1.605 -1.890 10.700 
vp -0.745 -0.654 0.500 
cstype rat bezier 

deg 3 

curv2 -6 -5 -4 -3 -2 -1 
parm u 0.00 1.00 2.00 
end 

# special curve 

AO On OS Om size 

nige) Wg AL (ol a tshalts} 

vas) dlaisDZi We ZA0)y/ 

VO one OR 455 

curv2 -4 -3 -2 -1 

parm u 2.00 10.00 

end 

# surface 

v -1.350 -1.030 0.000 

v7 10,130) = 0810) 043.2; 7 
v 1.480 -1.030 0.000 2 
v -1.460 0.060 0.201 

we WndkAo WS) Wecubsy 
VS CO OR OO OMORA 5 Aner 
Valk SOM 1 OS ONO O00) 2 
Vi Ort OM OS OM ORS 9:46 
Neale le Oe O SOMO) OOORS 
cstype rat bspline 

deg 2 2 

surf 

parm 

parm 

mim O70 25001 

fyohanie ClO So 

end 
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Trimming with special points 


This example extends the example, “Trimmed NURB surface” 


on page 31, to include special points on both the trimming 


curve and surface. A space curve with a special point is also 


included. This example uses negative vertex numbers. 


# special point and space curve data 


vp 


< 


0. 
Or 
ihe 
OQ. 


500 
700 
100 
200 


.300 
.000 
.000 
.000 
.000 


ORS 


50 


Le UOMOr 


0. 
ile 
ils 
0. 


000 
000 
000 
000 


cstype bezier 
deg 3 
curv 0.2 0.9 -4 -3 -2 -1 


sp 


1 


parm u 0.00 1.00 
end 
# trimming curve 


Wi =O) 67/5)) 1.850 37..010'0 
VON OL Ome. 9310 
Vimeo) Ona Olee2 01010 
vp 2.485) =1).03'0 

Vr O05) il. S9i0r NON 7/00 
vp -0.745 -0.654 0.500 
cstype rat bezier 

curv2 -6 -5 -4 -3 -2 -1 
parm u 0.00 1.00 2.00 
sp 2 3 

end 

# surface 

v -1.350 -1.030 0.000 

ve Ons =a 080 MOR43 25 77 
v 1.480 -1.030 0.000 2. 
v -1.460 0.060 0:.2.01 

Ve OL L20F SOO 60 0 OU' 50K 
Ve LeSc0r SOS060 O45 aya 
Vi 480) 913030) 02000) 2: 


600 
300 


500 
500 
300 
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To Om ZN arnOS0 OR S94. 61010 

wy dL gO, a OG) WOOO sh. soe 

cstype rat bspline 

deg 2 2 

surf -1.0 2.5 -2.0 2.0 -9 -8 -7 -6 -5 -4 -3 -2 -1 
joekan OL =k {00 suk. OO) <ul OO) AoS0) Aosae Basso) 

parm v -2.00 -2.00 -2.00 2.00 2.00 2.00 

obi O50 250) al 

sp 4 

end 
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Syntax 


Connectivity connects two surfaces along their trimming curves. 


The con statement specifies the first surface with its trimming 
curve and the second surface with its trimming curve. This 
information is useful for edge merging. Without this surface and 
curve data, connectivity must be determined numerically at 
greater expense and with reduced accuracy using the mg 
statement. 


Connectivity between surfaces in different merging groups is 
ignored. Also, although connectivity which crosses points of 
C'discontinuity in trimming curves is legal, it is not 
recommended. Instead, use two connectivity statements which 
meet at the point of discontinuity. 


The two curves and their starting and ending parameters should 
all map to the same curve and starting and ending points in 
object space. 


con surf_1 g0O_1 q1_1 curv2d_1 surf_2 qO_2 q1_2curv2d_2 


Free-form geometry statement. 
Specifies connectivity between two surfaces. 


surf_1 is the index of the first surface. 


q0_1 is the starting parameter for the curve referenced by 
curv2d_1. 


q1_1 is the ending parameter for the curve referenced by 
curv2d_1. 
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curv2d_1 is the index of a curve on the first surface. This curve 
must have been previously defined with the curv2 statement. 


surf_2 is the index of the second surface. 


q0_2 is the starting parameter for the curve referenced by 
curv2d_2. 


q1_2 is the ending parameter for the curve referenced by 
curv2d_2. 


curv2d_2 is the index of a curve on the second surface. This 
curve must have been previously defined with the curv2 
statement. 
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Example 
1 Connectivity between two surfaces 


This example shows the connectivity between two surfaces 
with trimming curves. 


cstype bezier 
deg 1 1 


0 
0 
1 
aL 


<<< 
FORO 
je AS Sele a 


(ibe il ye} Ay Gl 
parm uw 10/010) 220) 3510 450 
end 


SuUbE 1010 
parm u 0. 
parm v 0. 
trim 0.0 


Oc) oO al 4 ey a 
o@ 
0) 
il 


fo oO FE 
eet) fee 


[eat Peet Ley Ce} 
ooo °o 


surf 0.0 
parm u 0. 
parm v 0. 
texauliny (0) 10) 
end 


oO) oO ys & 7 


rOoOOrF 
OVS eS 
jem eh Sh el 


feral Ab A) gk) ah 2 CeO) si aio) al 
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Grouping 


There are four statements in the .obj file to help you manipulate 
groups of elements: 


¢ Group name statements are used to organize collections of 
elements and simplify data manipulation for operations in 
Model. 


¢ Smoothing group statements let you identify elements over 
which normals are to be interpolated to give those elements a 
smooth, non-faceted appearance. This is a quick way to 
specify vertex normals. 


¢ Merging group statements are used to identify free-form 
elements that should be inspected for adjacency detection. 
You can also use merging groups to exclude surfaces which 
are close enough to be considered adjacent but should not be 
merged. 


e Object name statements let you assign a name to an entire 
object in a single file. 


All grouping statements are state-setting. This means that once a 
group statement is set, it applies to all elements that follow until 
the next group statement. 


This portion of a sample file shows a single element which 
belongs to three groups. The smoothing group is turned off. 


g square thing all 
S Off 
2 tA A 


This example shows two surfaces in merging group 1 witha 
merge resolution of 0.5. 


MCS 
chblrens (a0) ahs) al A sk el 1) Oy as) ©) ay “ala aly ake} abs abs) alls 
Sure ORO ESO de PL Seiko 20212202324 25 21627 2ee29 
SHO) Shak 1S) 
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Syntax 
g group_name1 group_namez2... 


Polygonal and free-form geometry statement. 

Specifies the group name for the elements that follow it. You 
can have multiple group names. If there are multiple groups 
on one line, the data that follows belong to all groups. Group 
information is optional. 


group_name is the name for the group. Letters, numbers, and 
combinations of letters and numbers are accepted for group 
names. The default group name is default. 


S group_number 


Polygonal and free-form geometry statement. 

Sets the smoothing group for the elements that follow it. If 
you do not want to use a smoothing group, specify off or a 
value of 0. 


To display with smooth shading in Model and PreView, you 
must create vertex normals after you have assigned the 
smoothing groups. You can create vertex normals with the vn 
statement or with the Model program. 


To smooth polygonal geometry for rendering with Image, it is 
sufficient to put elements in some smoothing group. 
However, vertex normals override smoothing information for 
Image. 


group_number is the smoothing group number. To turn off 
smoothing groups, use a value of 0 or off. Polygonal elements 
use group numbers to put elements in different smoothing 
groups. For free-form surfaces, smoothing groups are either 
turned on or off; there is no difference between values greater 
than 0. 


mg group_number res 


Free-form geometry statement. 

Sets the merging group and merge resolution for the 
free-form surfaces that follow it. If you do not want to use a 
merging group, specify off or a value of 0. 


Adjacency detection is performed only within groups, never 
between groups. Connectivity between surfaces in different 
merging groups is not allowed. Surfaces in the same merging 
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group are merged together along edges that are within the 
distance res apart. 


Adjacency detection is an expensive numerical comparison 
process. It is best to restrict this process to as small a domain as 
possible by using small merging groups. 


group_number is the merging group number. To turn off 
adjacency detection, use a value of 0 or off. 


res is the maximum distance between two surfaces that will be 
merged together. The resolution must be a value greater than 
0. This is a required argument only when using merging 
groups. 


o object_name 


Polygonal and free-form geometry statement. 

Optional statement; it is not processed by any Wavefront 
programs. It specifies a user-defined object name for the 
elements defined after this statement. 


object_name is the user-defined object name. There 
is no default. 
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Cube with group names 


The following example is a cube with each of its faces placed 
in a separate group. In addition, all elements belong to the 
group cube. 
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Two adjoining squares with a smoothing group 


This example shows two adjoining squares that share a 
common edge. The squares are placed in a smoothing group 
to ensure that their common edge will be smoothed when 
rendered with Image. 
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Two adjoining squares with vertex normals 


This example also shows two squares that share a common 
edge. Vertex normals have been added to the corners of each 
square to ensure that their common edge will be smoothed 
during display in Model and PreView and when rendered 


with Image. 
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Merging group 


This example shows two Bezier surfaces that meet at a 
common edge. They have both been placed in the same 
merging group to ensure continuity at the edge where they 
meet. This prevents “cracks” from appearing along the seam 
between the two surfaces during rendering. Merging groups 
will be ignored during flat-shading, smooth-shading, and 
material shading of the surface. 
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surf 0.000000 1.000000 0.000000 1.000000 13 14 \ 
Sy, aay ) allo) aha aler By (7 ish all gh 
parm u 0.000000 1.000000 
parm v 0.000000 1.000000 
end 
surf 0.000000 1.000000 0.000000 1.000000 29 30 31 
aye) Fi) AG PA PAY Pl, AAD \ 
Sh PAGS alah alisy als) 2O) 
parm u 0.000000 1.000000 
parm v 0.000000 1.000000 
end 


Display/render attributes 


46 


Display and render attributes describe how an object looks when 
displayed in Model and PreView or when rendered with Image. 


Some attributes apply to both free-form and polygonal geometry, 
such as material name and library, ray tracing, and shadow 
casting. Interpolation attributes apply only to polygonal 
geometry. Curve and surface resolutions are used for only 
free-form geometry. 


The following chart shows the display and render statements 
available for polygonal and free-form geometry. 


Table 2-1. Display and render attributes 


polygonal only polygonal or 


free-form 


free-form only 


bevel lod 
c_interp usemtl stech 
d_interp mtllib 

shadow_obj 


trace_obj 


All display and render attribute statements are state-setting. This 
means that once an attribute statement is set, it applies to all 
elements that follow until it is reset to a different value. 


Wavefront Object File Format 


Syntax 


Tip 
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Display/render attributes 


The following sample shows rendering and display statements 
for a face element.: 


Sues 

usemtl blue 
usemap marble 
ze UE Ay ey a! 


The following syntax statements are listed by the type of 
geometry. First are statements for polygonal geometry. Second 
are statements for both free-form and polygonal geometry. Third 
are statements for free-form geometry only. 


bevel on | off 


Polygonal geometry statement. 
Sets bevel interpolation on or off. It works only with beveled 
objects, that is, objects with sides separated by beveled faces. 


Bevel interpolation uses normal vector interpolation to give 
an illusion of roundness to a flat bevel. It does not affect the 
smoothing of non-bevelled faces. 


Bevel interpolation does not alter the geometry of the original 
object. 


on turns on bevel interpolation. 


off turns off bevel interpolation. The default is off. 


Image cannot render bevel-interpolated elements that have vertex 
normals. 


c_interp on | off 


Polygonal geometry statement. 
Sets color interpolation on or off. 


Color interpolation creates a blend across the surface of a 
polygon between the materials assigned to its vertices. This 
creates a blending of colors across a face element. 


To support color interpolation, materials must be assigned 
per vertex, not per element. The illumination models for all 
materials of vertices attached to the polygon must be the 
same. Color interpolation applies to the values for ambient 
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(Ka), diffuse (Kd), specular (Ks), and specular highlight (Ns) 
material properties. 


on turns on color interpolation. 


off turns off color interpolation. The default is off. 


d_interp on | off 


Polygonal geometry statement. 
Sets dissolve interpolation on or off. 


Dissolve interpolation creates an interpolation or blend across 
a polygon between the dissolve (d) values of the materials 
assigned to its vertices. This feature is used to create effects 
exhibiting varying degrees of apparent transparency, as in 
glass or clouds. 


To support dissolve interpolation, materials must be assigned 
per vertex, not per element. All the materials assigned to the 
vertices involved in the dissolve interpolation must contain a 
dissolve factor command to specify a dissolve. 


on turns on dissolve interpolation. 


off turns off dissolve interpolation. The default is off. 


lod /evel 


Polygonal and free-form geometry statement. 

Sets the level of detail to be displayed ina PreView animation. 
The level of detail feature lets you control which elements of 
an object are displayed while working in PreView. 


level is the level of detail to be displayed. When you set the 
level of detail to 0 or omit the lod statement, all elements are 
displayed. Specifying an integer between 1 and 100 sets the 
level of detail to be displayed when reading the .obj file. 


maplib filename? filenamez... 
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This is a rendering identifier that specifies the map library file 
for the texture map definitions set with the usemap identifier. 
You can specify multiple filenames with maplib. If multiple 

filenames are specified, the first file listed is searched first for 
the map definition, the second file is searched next, and so on. 


When you assign a map library using the Model program, 
Model allows only one map library per .obj file. You can 
assign multiple libraries using a text editor. 
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filename is the name of the library file where the texture maps 
are defined. There is no default. 


usemap map_name | off 


This is a rendering identifier that specifies the texture map 
name for the element following it. To turn off texture 
mapping, specify off instead of the map name. 


If you specify texture mapping for a face without texture 
vertices, the texture map will be ignored. 


map_name is the name of the texture map. 


off turns off texture mapping. The default is off. 


usemtl material_name 


Polygonal and free-form geometry statement. 

Specifies the material name for the element following it. Once 
a material is assigned, it cannot be turned off; it can only be 
changed. 


material_name is the name of the material. If a material name is 
not specified, a white material is used. 


mtllib filename? filename2... 


Polygonal and free-form geometry statement. 

Specifies the material library file for the material definitions 
set with the usemtl statement. You can specify multiple 
filenames with mtllib. If multiple filenames are specified, the 
first file listed is searched first for the material definition, the 
second file is searched next, and so on. 


When you assign a material library using the Model program, 
only one map library per .obj file is allowed. You can assign 
multiple libraries using a text editor. 


filename is the name of the library file that defines the 
materials. There is no default. 


shadow_obj filename 


Polygonal and free-form geometry statement. 

Specifies the shadow object filename. This object is used to 
cast shadows for the current object. Shadows are only visible 
in a rendered image; they cannot be seen using hardware 
shading. The shadow object is invisible except for its shadow. 
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An object will cast shadows only if it has a shadow object. You 
can use an object as its own shadow object. However, a 
simplified version of the original object is usually preferable 
for shadow objects, since shadow casting can greatly increase 
rendering time. 


filename is the filename for the shadow object. You can enter 
any valid object filename for the shadow object. The object file 
can be an .obj or .mod file. If a filename is given without an 
extension, an extension of .obj is assumed. 


Only one shadow object can be stored in a file. If more than 
one shadow object is specified, the last one specified will be 
used. 


trace_obj filename 


Polygonal and free-form geometry statement. 

Specifies the ray tracing object filename. This object will be 
used in generating reflections of the current object on 
reflective surfaces. Reflections are only visible in a rendered 
image; they cannot be seen using hardware shading. 


An object will appear in reflections only if it has a trace object. 
You can use an object as its own trace object. However, a 
simplified version of the original object is usually preferable 
for trace objects, since ray tracing can greatly increase 
rendering time. 


filename is the filename for the ray tracing object. You can 
enter any valid object filename for the trace object. You can 
enter any valid object filename for the shadow object. The 
object file can be an .obj or .mod file. If a filename is given 
without an extension, an extension of .obj is assumed. 


Only one trace object can be stored in a file. If more than one 
is specified, the last one is used. 


ctech technique resolution 
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Free-form geometry statement. 
Specifies a curve approximation technique. The arguments 
specify the technique and resolution for the curve. 


You must select from one of the following three techniques. 
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ctech cparm res 


Specifies a curve with constant parametric subdivision using 
one resolution parameter. Each polynomial segment of the 
curve is subdivided n times in parameter space, where n is the 
resolution parameter multiplied by the degree of the curve. 


res is the resolution parameter. The larger the value, the finer 
the resolution. If res has a value of 0, each polynomial curve 
segment is represented by a single line segment. 


ctech cspace maxlength 


Specifies a curve with constant spatial subdivision. The curve 
is approximated by a series of line segments whose lengths in 
real space are less than or equal to the maxlength. 


maxlength is the maximum length of the line segments. The 
smaller the value, the finer the resolution. 


ctech curv maxdist maxangle 


Specifies curvature-dependent subdivision using separate 
resolution parameters for the maximum distance and the 
maximum angle. 


The curve is approximated by a series of line segments in 
which 1) the distance in object space between a line segment 
and the actual curve must be less than the maxdist parameter 
and 2) the angle in degrees between tangent vectors at the 
ends of a line segment must be less than the maxangle 
parameter. 


maxdist is the distance in real space between a line segment 
and the actual curve. 


maxangle is the angle (in degrees) between tangent vectors at 
the ends of a line segment. 
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Tip 


The smaller the values for maxdist and maxangle, the finer the 
resolution. 


Approximation information for trimming, hole, and special 
curves is stored in the corresponding surface. The ctech statement 
for the surface is used, not the ctech statement applied to the curv2 
statement. Although untrimmed surfaces have no explicit 
trimming loop, a loop is constructed which bounds the legal 
parameter range. This implicit loop follows the same rules as any 
other loop and is approximated according to the ctech information 
for the surface. 


stech technique resolution 


Free-form geometry statement. 
Specifies a surface approximation technique. The arguments 
specify the technique and resolution for the surface. 


You must select from one of the following techniques: 
stech cparma ures vres 


Specifies a surface with constant parametric subdivision 
using separate resolution parameters for the u and v 
directions. Each patch of the surface is subdivided n times in 
parameter space, where 11 is the resolution parameter 
multiplied by the degree of the surface. 


ures is the resolution parameter for the u direction. 
vres is the resolution parameter for the v direction. 


The larger the values for ures and vres, the finer the resolution. 
If you enter a value of 0 for both ures and vres, each patch is 
approximated by two triangles. 


stech cparmb uvres 


Specifies a surface with constant parametric subdivision, with 
refinement using one resolution parameter for both the u and 
v directions. 


An initial triangulation is performed using only the points on 
the trimming curves. This triangulation is then refined until 
all edges are of an appropriate length. The resulting triangles 
are not oriented along isoparametric lines as they are in the 
cparma technique. 
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uvres is the resolution parameter for both the u and v 
directions. The larger the value, the finer the resolution. 


stech cspace maxlength 


Specifies a surface with constant spatial subdivision. 


The surface is subdivided in rectangular regions until the 
length in real space of any rectangle edge is less than the 
maxlength. These rectangular regions are then triangulated. 


maxlength is the length in real space of any rectangle edge. The 
smaller the value, the finer the resolution. 


stech curv maxdist maxangle 


Specifies a surface with curvature-dependent subdivision 
using separate resolution parameters for the maximum 
distance and the maximum angle. 


The surface is subdivided in rectangular regions until 1) the 
distance in real space between the approximating rectangle 
and the actual surface is less than the maxdist (approximately) 
and 2) the angle in degrees between surface normals at the 
corners of the rectangle is less than the maxangle. Following 
subdivision, the regions are triangulated. 


maxdist is the distance in real space between the 
approximating rectangle and the actual surface. 


maxangle is the angle in degrees between surface normals at 
the corners of the rectangle. 


The smaller the values for maxdist and maxangle, the finer the 
resolution. 


53 


Display/render attributes 


Examples 


54 


Cube with materials 


This cube has a different material applied to each of its faces. 


mtllib master.mtl 
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2 Cube casting a shadow 


In this example, the cube casts a shadow on the other objects 
when it is rendered with Image. The cube, which is stored in 
the file cube.obj, references itself as the shadow object. 


mtllib master.mtl 
shadow_obj cube.obj 
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3 Cube casting a reflection 


This cube casts its reflection on any reflective objects when it 
is rendered with Image. The cube, which is stored in the file 
cube.obj, references itself as the trace object. 


mtllib master 
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trace_obj cube.obj 
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This example describes a 2 x 2 square. It is mapped witha 1 x 


1 square texture. The texture is stretched to fit the square 


exactly. 


mtllib master.mtl 


v 0.000000 2.000000 
v 0.000000 0.000000 
v 2.000000 0.000000 
v 2.000000 2.000000 
vt 0.000000 1.000000 
vt 0.000000 0.000000 
vt 1.000000 0.000000 
vt 1.000000 1.000000 
# 4 vertices 


usemtl wood 
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Approximation technique for a surface 


This example shows a B-spline surface which will be 
approximated using curvature-dependent subdivision 
specified by the stech command. 
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Approximation technique for a curve 


This example shows a Bezier curve which will be 
approximated using constant parametric subdivision 
specified by the ctech command. 


-2.300000 1.950000 0.000000 
-2.200000 0.790000 0.000000 
-2.340000 -1.510000 0.000000 
-1.530000 -1.490000 0.000000 
-0.720000 -1.470000 0.000000 
-0.780000 0.230000 0.000000 
0.070000 0.250000 0.000000 
0.920000 0.270000 0.000000 
0.800000 -1.610000 0.000000 
1.620000 -1.590000 0.000000 
2.440000 -1.570000 0.000000 
2.690000 0.670000 0.000000 
2.900000 1.980000 0.000000 
13 vertices 


#qg<dsses9dd09099 9 4 4 


g default 

cstype bezier 

ctech cparm 1.000000 

deg 3 

curv 0.000000 4.000000 12345 6789 10 \ 
ala key ali! 

parm u 0.000000 1.000000 2.000000 3.000000 \ 
4.000000 

end 

# 1 element 


Comments can appear anywhere in an .obj file. They are used to 
annotate the file; they are not processed. 


Here is an example: 


# this is a comment 


The Model program automatically inserts comments when it 
creates .obj files. For example, it reports the number of geometric 
vertices, texture vertices, and vertex normals in a file. 


# 4 vertices 
# 4 texture vertices 
# 4 normals 
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Mathematics for free-form curves/surfaces 


General forms 


Rational and non-rational curves and surfaces 


In general, any non-rational curve segment may be written as: 


K 
(Q((9) d,N; ue) 
i=0 
where 
K+1 is the number of control points 
d; are the control points 
n is the degree of the curve 
Nj p(t) are the degree n basis functions 


Extending this to the bivariate case, any non-rational surface 
patch may be written as: 


K, K, 
S(uv) = Yd, Nm ON, 2 () 
i=0j=0 
where: 
K,+1 is the number of control points in the u direction 
K)+1 is the number of control points in the v direction 
dj are the control points 
m is the degree of the surface in the u direction 
n is the degree of the surface in the v direction 
Ni mw) are the degree m basis functions in the u direction 
Nj n(0) are the degree n basis functions in the v direction 
Tip The front of the surface is defined as the side where the u 
parameter increases to the right and the v parameter increases 
upward. 
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We may extend this curve to the rational case as: 


waN.. (t) 


ibe Mita 


w.N. (ft) 


in 
i=0 


where w; are the weights associated with the control points dj. 
Similarly, a rational surface may be expressed as: 


ie 1S; 


Sy 1/9, Nim ON) 


— i= j= 
S(u,v) = ee Sree eee a 


» Wi Nim (ON, 
i=0j=0 


where w; ; are the weights associated with the control points dj. 


Tip If a curve or surface in an .obj file is rational, it must use the rat 
option with the cstype statement and it requires some weight 
values for each control point. 


The weights for the rational form are given as a third control point 
coordinate (for trimming curves) or fourth coordinate (for space 
curves and surfaces). These weights are optional and default to 1.0 
if not given. 


This default weight is only reasonable for curves and surfaces 
whose basis functions sum to 1.0, such as Bezier, Cardinal, and 
NURB. It does not make sense for Taylor and may or may not 
make sense for a representation given in basis-matrix form. 


For all forms other than B-spline, the final curve or surface is 
constructed by piecing together the individual curve segments or 
surface patches. A global parameter space is then defined over 
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Tip 


the entire composite curve or surface using the parameter vector 
given with the parm statement. 


The parameter vector for a curve is a list of p global parameter 
values {1), ..., Tp}, If tT) $T< 14; is a point in global parameter 
space, then: 


is the corresponding point in local parameter space for the ith 
polynomial segment. It is this t which is used when evaluating a 
given segment of the piecewise curve. For surfaces, this mapping 
from global to local parameter space is applied independently in 
both the u and v parametric directions. 


B-splines require a knot vector rather than a parameter vector, 
although this is also given with the parm statement. Refer to the 
description of B-splines below. 


The following discussion of each type is expressed in terms of the 
above definitions. 


The maximum degree for all curve and surface types is currently 
set at 20, which is high enough for most purposes. 


Free-form curve and surface types 
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B-spline 


Type bspline specifies arbitrary degree non-uniform B-splines 
which are commonly referred to as NURBs in their rational form. 
The basis functions are defined by the Cox-deBoor recursion 
formulas as: 


ee eee 
, 0 otherwise 
and: 
N.._,(t) N. (1) 
be Taree 
IO) Se 
Nien i Cea es | meeps 
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where, by convention, 0/0 = 0. 


The x; € {X0,+++Xqt form a set known as the knot vector which is 
given by the parm statement. It is required that 


1 XjS%j47 
Xo <%n +1, 
Xq-n-1 <%q, 


Xj<Xj4,for0<i<q-n-1, 


a & WO RN 


Xn St min < tinax S XK+ 1, Where [tins tax] is the parameter 
over which the B-spline is to be evaluated, and 


6 K=q-n-1. 
A knot is said to be of multiplicity r if its value is repeated r times 
in the knot vector. The second through fourth conditions above 


restrict knots to be of at most multiplicity n + 1 at the ends of the 
vector and at most 1 everywhere else. 


The last condition requires that the number of control points is 
equal to one less than the number of knots minus the degree. For 
surfaces, all of the above conditions apply independently for the 
u and v parametric directions. 


Bezier 


Type bezier specifies arbitrary degree Bezier curves and surfaces. 
This basis function is defined as: 


N,, (1) = Gren 
where: 


When using type bezier, the number of global parameter values 
given with the parm statement must be K/n + 1, where K is the 
number of control points. For surfaces, this requirement applies 
independently for the u and v parametric directions. 
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Cardinal 


Type cardinal specifies a cubic, first derivative, continuous curve 
or surface. For curves, this interpolates all but the first and last 
control points. For surfaces, all but the first and last row and 
column of control points are interpolated. 


Cardinal splines, also known as Catmull-Rom splines, are best 
understood by considering the conversion from Cardinal to 
Bezier control points for a single curve segment: 


Here, the c; variables are the Cardinal control points and the b; 
variables are the Bezier control points. We see that the second and 
third Cardinal points are the beginning and ending points for the 
segment, respectively. Also, the beginning tangent lies along the 
vector from the first to the third point, and the ending tangent 
along the vector from the second to the last point. 


If we let B,(t) be the cubic Bezier basis functions (i.e. what was 
given above for Bezier as N; ,,(t) with n = 3), then we may write 
the Cardinal basis functions as: 


Note) = ZB, (t) 


= By(t) +B, (t) + 2B, (0) 


<= 
wb 

— 

= 

= 
| 


= By (t) +B, (t) +B, (1) 


= 
iS 
w 

~~ 

S 

= 
| 


353 (t) = -ZB, (1) 


Note that Cardinal splines are only defined for the cubic case. 
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When using type cardinal, the number of global parameter values 
given with the parm statement must be K - n + 2, where K is the 
number of control points. For surfaces, this requirement applies 
independently for the uv and v parametric directions. 


Taylor 


Type taylor specifies arbitrary degree Taylor polynomial curves 
and surfaces. The basis function is simply: 


i 
N,. n (t) ae 


Tip The control points in this case are the polynomial coefficients and 
have no obvious geometric significance. 


When using type taylor, the number of global parameter values 
given with the parm statement must be (K + 1)(n + 1) + 1, where 
Kis the number of control points. For surfaces, this requirement 
applies independently for the u and v parametric directions. 
Basis matrix 


Type bmatrix specifies general, arbitrary-degree curves defined 
through the use of a basis matrix rather than an explicit type such 
as Bezier. The basis functions are defined as: 


n 
Ni.) = ¥ b, it 


j=0 


where the basis matrix is the bj ;. In order to make the matrix 
nature of this more obvious, we may also write: 


Non) b , 


‘fete a) eed Cee eae Pe 


Object Files (.obj) 65 


Mathematics for free-form curves/surfaces 


When constructing basis matrices, you should keep this 
definition in mind, as different authors write this in different 
ways. A more common matrix representation is: 


Ne lnnlGa aise orale? 


Neb) b [ 


To use such matrices in the .obj file, simply transpose the matrix 
and reverse the column ordering. 


When using type basis, the number of global parameter values 
given with the parm statement must be (K - n)/s + 2, where K is 
the number of control points and s is the step size given with the 
step statement. For surfaces, this requirement applies 
independently for the u and v parametric directions. 
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Control points 


The control points for a surface consisting of a single patch are 
listed in the order i = 0 to K, for j = 0, followed by i = 0 to Ky for 
j=1,and so on until j = Kp. 


For surfaces made up of many patches, which is the usual case, 
the control points are ordered as if the surface were a single large 
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patch. For example, the control points for a bicubic Bezier surface 
consisting of four patches would be arranged as follows: 


42 — 43 — 44 — 45— 46— 47— 48 
| | | 
35 36 37 38 39 40 41 


| | | 
28 29 30 31 32 33 34 


| | | 
Db PVE Dy 
| | | 
14 15 16 17 18 19 20 
| | | 
7 8 Oe 10 Ai ioe ae 
| | | 
0—1—2—3—4—5—6 
-— 


<> 


where (11, v) is the global parameter space of the surface and the 
numbers indicate the ordering of the vertex indices in the surf 
statement. 


Texture vertices and texture mapping 


When texture vertices are not supplied, the original surface 
parameterization is used for texture mapping. However, if 
texture vertices are supplied, they are interpreted as additional 
information to be interpolated or approximated separately from, 
but using the same interpolation functions as the control vertices. 


That is, whereas the surface itself, in the non-rational case, was 
given in the section “Rational and non-rational curves and 
surfaces” on page 60 as: 


K, K, 


S(u,v) = > ¥ 4, NV im) N, 2 (¥) 


i= Oj =0 


the texture vertices are interpolated or approximated by: 


where t; ; are the texture vertices and the basis functions are the 
same as for S(u ,v). It is T(u,v), rather than the surface 
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KameKe 


CD) D2 DER OG yal) 


i=O0j=0 


parameterization (u,v), which is used when a texture map is 
applied. 


Vertex normals and normal mapping 


Vertex normals are treated exactly like texture vertices. When 
vertex normals are not supplied, the true surface normals are 
used. If vertex normals are supplied, they are calculated as: 


Mm LS 
O(uv) = a Nim ON, 


att 
i=0j=0 


where qj; ; are the vertex normals and the basis functions are the 
same as (or S(u,v) and T(u,v). 


Tip Vertex normals do not affect the shape of the surface; they are 
simply associated with the triangle vertices in the final 
triangulation. As with faces, supplying vertex normals only 
affects lighting calculations for the surface. 


The treatment of both texture vertices and vertex normals in the 
case of rational surfaces is identical. It is important to notice that 
even when the surface S(u,v) is rational, the texture and normal 
surfaces, T(u,v) and Q(u,v), are not rational. This is because the 
control points (the texture vertices and vertex normals) are never 
rational. 


Curve and surface operations 


Special points 


The following equations give a more precise description of 
special points for space curves and discuss the extension to 
trimming curves and surfaces. 
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Let C(t) be a space curve with the global parameter t. We can 
approximate this curve by a set of k-1 line segments which 
connect the points: 


ipa ee = CT eee 


for some set of k global parameter values {11,...,T,)- 


Given a special point T, in the parameter space of the curve 
(referenced by vp), we guarantee that T, € {T),...,7,}. More 
specifically, we approximate the curve by: 


Cry) imc rey reer) 


where, at the point 7 where T, is inserted, we have 7; $ Tg < zi41- 


Special curves 


The following equations give a more precise description of a 
special curve. 


Let T(t) be a special curve with the global parameter t. We have: 


(u,v) = F(t) 


where (l1,v) is a point in the global parameter space of a surface. 
We can approximate this curve by a set of k-1 line segments 
which connect the points: 


CL (Ty cat 


for some set of k global parameter values. 


Let S(u,v) be a surface with the global parameters and v. We can 
approximate this surface by a triangulation of a set of p points. 


{S(HjV])> ++ S (Mey H,) F 
which lie on the surface. We further define E as the set of all 
edges such that ej € E implies that S(u1;,v;) and S(U4,,Vj) are 


connected in the triangulation. Finally, we guarantee that there 
exists some subset of E: 


{1 > en Las 


such that the points: 
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{S(T(%)), -- S(T (%)) } 


are connected in the triangulation. 


Recall that the syntax of the con statement is: 


(elojal cpbhare il (of0)_ il foph al (etbhay yell fais 7) (o(_ 7 pl Ah yehayAol 7) 


If we let: 

T(t) be the curve referenced by curv2d_1 

S,(Uy,V1) be the surface referenced by surfl on which Tj(t,) lies 
T(t) be the curve referenced by curv2d_2 


S>(U2, V2) be the surface referenced by surf2 on which T(t) lies 


then S;(T,(71)), S2(T(t2)) must be identical up to 
reparameterization. Moreover, it must be the case that: 


S;(T1(q0_1)) = So(T2(q0_2)) 
and: 
S,(T1(q1_1)) = So(T2(q1_2)) 


It is along the curve S,(T,(t,)) between t; = q0_1 and tT, = q1_1, 
and the curve S>(T>(t7)) between tT, = q0_2 and 7 = q1_2 that the 
surface S;(11, V;) is connected to the surface S>({U9, V>). 
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Reading and writing .obj files 


When you are importing objects from external databases to read 
into 3Design using the .obj format, we recommend that the 
objects be well-defined solids with no edge shared by more than 
two facets. If you do encounter problems with editing translated 
data, try using the Polygon/Clean command in 3Design. This 
might clean up multiple shared edges and vertices. 


The .obj keywords supported by 3Design are shown below. A 
keyword defines the property of an entity, for example, a polygon 
or surface. The following table indicates which keywords can be 
read and written by 3Design. Occasionally you may experience a 
problem as a result of using .obj files in either 3Design or Model. 
These tables are intended to help you avoid keyword-related 
problems. 


Table 2. .obj keywords read and written by 3Design 
Keyword Meaning Written Read 
# Comment 
\ Line continuation 
bmat u Bmatrix in u (Bmatrix is converted to NURBs) 


bmat v Bmatrix in u (Bmatrix is converted to NURBs) 


con Surface connectivity 


cstype Curve/surface type. 3Design writes all displayed 
curves and surfaces as NURBs, and all uv trimming 
curves as Beziers. 


cstype Curve/surface type. 3Design reads all curve and 
surface types supported by Model, but all 
non-NURBs entities are converted to NURBs. 


curv 3D curve 
curv2 UV trimming curve 


curv3 3D trimming curve 


deg Curve/surface degree 
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Table 2. .obj keywords read and written by 3Design (Continued) 


Keyword Meaning Written Read 


end Curve/surface end ° ° 
i Face ° ° 
g Group ° C 
hole Trimming hole data ° s 
parmu  Curve/surface parameter range in u ° ° 
parmv Surface parameter range in v ° ° 
s Smoothing group e . 
scrv Special trimming curve ° 
surf 3D surface C ° 
trim Outer trim data ° . 
usemtl Material assignment ° ° 
v Vertex e 0 
on Vertex normal ° 


Vertex parameter ° ° 


Table 3. .obj keywords not read or written by 3Design 


Keyword Meaning Comment 


Bspline patch These keywords are not supported because they 
refer to obsolete geometry entities that are no 
longer created in Advanced Visualizer’s Model. If 
you have old files with these entities, you can read 
them into Advanced Visualizer’s Model, where 
cdp Cardinal patch they will be converted to NURBs, then save them 


back out as NURBs and read them into 3Design. 


Bezier patch 


cdc Cardinal curve 


res Patch resolution 


maplib 


Map library 


These two keywords are no longer used in 
Advanced Visualizer. 


usemap Map assignment 
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Table 3. .obj keywords not read or written by 3Design (Continued) 


Keyword Meaning _ Comment 


Merge group Refers to the Merge group operation. We 
recommend using the con statement (connectivity) 


instead of mg. 


mtllib Material Library Sets the material library, and is best selected while 
in Model. However, we recommend to set a 
material library using Project Setup in Director 
instead of using mtllib. 


bevel Bevel interpolation 
c_interp Color interpolation 


d_interp Dissolve 


interpolation These keywords are related to creating rendering 
effects that are specific to rendering in Advanced 
shadow_obj  .obj to use as Visualizer’s Image. If you want to use them, you 
shadow object can recreate them in Model. 
trace_obj _ .obj to use as trace 


object 


ctech Curve 


een These keywords are related to the method and 
technique : : : 
resolution used in tessellating surfaces and curves 
stech Surface for Advanced Visualizer only. If you want to use 
approximation them, you can recreate them in Model. 


technique 


Level of detail This keyword is used to speed up display of 
complex objects in Model and PreView. If you want 


to use this keyword, you can recreate it in Model 


Special trimming 
point 


This keyword is rarely used, if at all. 


3D line 


The geometry entities represented by these 


; keywords are not supported in 3Design. 
p 3D point 


Texture vertex Texture vertices are not supported in 3Design. If 
you want to use texture vertices in the Advanced 


Visualizer, you can recreate them in Model. 
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